home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / pascal / tvtool2.zip / READ.ME < prev    next >
Text File  |  1993-07-20  |  11KB  |  274 lines
  1. TV TOOL BOX - Version 2.00                                      07/20/93
  2. ------------------------------------------------------------------------------
  3. OVERVIEW -
  4.  
  5. The TV Tool Box package was created to fill a few holes in Turbo Vision for
  6. Turbo Pascal. TV Tool Box includes formatted data entry with input masks,
  7. scrolling data entry dialogs, dialog box field locking, check mark menus,
  8. enhancements to TApplication, some handy string routines, scrolling dialog
  9. boxes, 3D controls, virtual list boxes, spin bars, slider controls, and more.
  10.  
  11. Version 2.0 of TV Tool Box is for use with Turbo Pascal version 7.0. It adds
  12. full support for Turbo Vision 2.0 and protected mode programs.
  13.  
  14. TV Tool Box is distributed as Shareware, IT IS NOT FREE. IF YOU USE TV TOOL
  15. BOX PLEASE REGISTER IT. With your paid registration you will receive the
  16. latest version with full source code (all units), printed documentation, and
  17. bonus disk(s) of TV source and utilities. Registration is $40.00 (U.S.) plus
  18. $5.00 shipping and handling.
  19.  
  20. You may register by check, money order, credit card, or online on the
  21. CompuServe information service. All registrations are $40.00 plus $5.00
  22. shipping and handling.
  23.  
  24. Checks or money orders are prefered if possible (especially for U.S. orders). 
  25. Please make all checks payable in U.S. dollars, drawn on a U.S. bank. Orders 
  26. paid by check drawn on a non-U.S. bank will be returned. I apologize for any 
  27. inconvenience but high bank charges, roughly 50%, make this necessary.
  28.  
  29. You can also register online on CompuServe. Type GO SWREG, and follow the
  30. prompts. The Registration Id for CompuServe is 1121. All Compuserve
  31. registrations are $45.00, including shipping and handling.
  32.  
  33. You may place an order by Master Card, VISA, American Express, or Discover by
  34. contacting Public Software Library at (800) 242-4PSL (from overseas
  35. (713) 524-6394), by FAX at (713) 524-6398, or on CompuServe at 71355,470.
  36. These numbers are for credit card orders only! Please, do not call these
  37. numbers for any type of technical assistance. The Registration Id for PSL is
  38. 10896. All PSL registrations are $45.00, including shipping and handling.
  39.  
  40. Site licenses and multiple copy discounts are available. Remember a
  41. registered copy is required for each programmer using TV Tool Box.
  42.  
  43. Please contact me with any comments, suggestions, problems, bugs, or
  44. questions.
  45.  
  46. Richard Hansen
  47. PO Box 18571
  48. Saint Paul, MN  55118-0571  USA
  49.  
  50. CompuServe : 70242,3367
  51. InterNet   : 70242.3367@compuserve.com
  52. FidoNet    : 1:282/115
  53.  
  54. TV Tool Box is a work in progress. What happens in any future version is
  55. partly up to you. If you have any ideas for new TV extensions please let me
  56. know and I will try to include them. FUTURE VERSIONS WILL BE AVAILABLE TO
  57. REGISTERED USERS FOR A NOMINAL FEE.
  58.  
  59. ------------------------------------------------------------------------------
  60. THE DEMO -
  61.  
  62. The file DEMO.PAS is the main demo for TV Tool Box.  This demo shows most of
  63. the features of TV Tool Box. Choose the [Test] option off the main menu bar
  64. to test them for yourself. Select [Data Entry] to test some new data entry
  65. features. TV Tool Box supports formatted data entry using programmer supplied
  66. entry mask strings. You can include literals, such as '(' or '-' in your
  67. masks, that cannot be typed over by your users. The data entry features also
  68. include, field locking, hidden password fields, justification, trimming,
  69. alternate padding chars, required fields, range checking, and support BP 7.0
  70. validators.
  71.  
  72. If you ever wanted a little fancier look in your TV apps (dare I say it),
  73. like Visual Basic for DOS, check out the 3D controls. The 3D controls
  74. include a vertical or horizontal tool bar (almost like windows!). 3D buttons
  75. can take up to two lines of text.
  76.  
  77. Select [Check Marks] and try out the check mark enhancement for menus.
  78.  
  79. If you have need of a ASCII/HEX editor, like those used in disk utilities,
  80. now you have got one. Select [Ascii/Hex Editor] to check it out.
  81.  
  82. Have you ever wanted a simple way to display some text without creating a
  83. dialog box or window and a specialized Draw method, try the [Text
  84. Display Window] option. This will display a TbxTextWindow object. With
  85. TbxTextWindow you just create it and use the Write method to display string,
  86. almost like writing to the screen without Turbo Vision.
  87.  
  88. If you select [Message Dialog], you can check out a replacement for the
  89. MessageBox procedure. A TbxMessageDialog will automatically size itself for
  90. the number and length of the lines of text you insert into it.
  91.  
  92. On the [Setup] menu, you can setup a neat idea I stole from my favorite
  93. programer's text editor "Multi-Edit" from American Cybernetics, Inc. If you
  94. check the option, the mouse cursor will be turned off whenever the keyboard
  95. is used. The mouse cursor is restored whenever the mouse is moved or a mouse
  96. button is pressed.
  97.  
  98. Included in TV Tool Box is a descendant of TDialog called TbxRunDialog. A
  99. TbxRunDialog is used to create progress display dialogs for things like
  100. printing, copying files, etc. TbxRunDialog has easy an method for
  101. implementing pause, continue, and cancel. There are two ready made
  102. descendants of TbxRunDialog, TbxPercentDialog and TbxPrintDialog.
  103. TbxPercentDialog displays the percentage completion with a progress bar.
  104. TbxPrintDialog is a skeleton for a printing dialog. Select [Progress Dialog]
  105. or [Print Dialog] to try them out.
  106.  
  107. [Virtual List Boxes] provide a list box that is perfect for database work or
  108. whenever you have a list that could be too large a normal TCollection.
  109. Virtual List Boxes display a only a portion of a larger (perhaps very much
  110. larger) list. Virtual List Box can page through the list or jump to the
  111. beginning or end of the list. The demo implements a list of all integers from
  112. 1 - 99999. This is obviously too large for a TCollection which can handle
  113. a maximum of 16384 elements.
  114.  
  115. I have added a couple enhancements to TWindows. A TbxWindow can be minimized,
  116. using the "" icon in the upper right corner. If you hit Alt-Minus, or press
  117. the right mouse button on the "close" icon, a window control menu will popup.
  118.  
  119. Please be sure and check out the file SCROLL.EXE for a look at scrolling
  120. dialogs and data entry windows. Also check out the documentation and *.INT
  121. files for a more complete view of what is included.
  122.  
  123. ------------------------------------------------------------------------------
  124. USING TV TOOL BOX -
  125.  
  126. TV Tool Box is broken into several units. The unit names generally correspond
  127. with their associated Turbo Vision units. The source code has been included
  128. to avoid compilation problems. Don't bother trying to read it though, it has
  129. been pretty well condensed (perhaps squashed describes it better) and is very
  130. hard to read. THE FULL SOURCE CODE IS INCLUDED WITH THE REGISTERED VERSION.
  131.  
  132. When you compile you should use the X+, B+, and V- compiler directives.
  133.  
  134. DEMO.PAS        Source code for the TV.EXE demo program.
  135.  
  136. SCROLL.PAS      Source code for the SCROLL.EXE demo program.
  137.  
  138. TVDEFS.INC      Some defs that change the compilation.
  139.  
  140. TVCONST.PAS     Global constants.
  141.  
  142. TVTYPE.PAS      Global types.
  143.  
  144. TVSTRING.PAS    Handy string routines.
  145.  
  146. TVINPUT.PAS     Data entry extensions.
  147.  
  148. TVVIEWS.PAS     View extensions.
  149.  
  150. TVDIALOG.PAS    Dialog extensions.
  151.  
  152. TVAPP.PAS       Application extensions.
  153.  
  154. TVMENUS.PAS     Menu extensions.
  155.  
  156. TVOBJECT.PAS    TObject and TCollection extensions.
  157.  
  158. TVSCROLL.PAS    Scrolling dialog boxes.
  159.  
  160. TV3D.PAS        3D dialog boxes and controls.
  161.  
  162. ------------------------------------------------------------------------------
  163. TV TOOL BOX DEVELOPMENT TOOLS -
  164.  
  165. TV Tool Box is actively supported by PtGen. PtGen is a Turbo Vision 2.0
  166. screen generator. You can reach the author of PtGen, Berend de Boer, at:
  167.  
  168.   CompuServe : 100120,3121
  169.   InterNet   : berend@contrast.wlink.nl
  170.   FidoNet    : 2:281/527.23
  171.  
  172. PtGen can create the layout for a whole application or a single dialog
  173. box. It is completely visual and interactive. Highlights of PtGen,
  174. besides supporting TV Tool Box are:
  175.  
  176. *  creates complete applications or standalone dialog boxes
  177. *  quick interactive menu building
  178. *  quick interactive status line building
  179. *  quick interactive dialog box building
  180. *  full helptext support for status line help as well as helpfiles (.HLP)
  181. *  a tutorial, covering creation of status lines, menus, and dialog boxes
  182.  
  183. PtGen currently supports all 3D controls of TV Tool Box. Basic support for
  184. the TbxEditLine (including mask definition) is also provided. Planned
  185. enhancements include supporting all input lines and support for scrolling
  186. dialog boxes.
  187.  
  188. Registered users of PtGen receive 25% reduction on their TV Tool Box package,
  189. just as registered users of TV Tool Box receive 25% reduction on their PtGen
  190. package. The shareware version of PtGen is shipped with every registered
  191. version of TV Tool Box.
  192.  
  193. ------------------------------------------------------------------------------
  194. HISTORY -
  195.  
  196.         09/05/92        Released version 1.0
  197.  
  198.         10/07/92        Released version 1.05
  199.  
  200.         07/20/93        Released version 2.0 for Turbo Pascal 7.0
  201.  
  202. ------------------------------------------------------------------------------
  203. WHAT'S NEW AND WHAT'S CHANGED -
  204.  
  205. Turbo Pascal 7.0 and Turbo Vision 2.0 support.
  206.  
  207. Protected mode support.
  208.  
  209. All Tv Tool Box objects renamed to start with the prefix "Tbx."
  210.  
  211. All Tv Tool Box object pointers renamed to start with Pbx.
  212.  
  213. TbxApplication.ClearBusy renamed to TbxApplication.HideBusy.
  214.  
  215. Full set of 3D controls implemented.
  216.  
  217. Actual help colors (not just place holders) included in 3D palette.
  218.  
  219. TCharBuf renamed to TbxCharArray.
  220.  
  221. TByteBuf renamed to TbxByteArray.
  222.  
  223. TLinkedListBox renamed to TbxLinkedBox.
  224.  
  225. TLinkedInputLine renamed to TbxLinkedLine.
  226.  
  227. TEditBuffWindow renamed to TbxASCIIHexEditor.
  228.  
  229. Added Multi-Select list boxes and Paired list boxes.
  230.  
  231. All stream registration methods and types implemented.
  232.  
  233. TvKeys unit consolidated into TvConst unit.
  234.  
  235. gfGrowXYRel changed to gfScrollXY
  236.  
  237. TbxScrollDialog.InsertToScroll sets the gfScrollXY flag in all inserted views.
  238.  
  239. Scrolling dialogs scrolls to focused view on Tab.
  240.  
  241. Scrolling dialog inserts a background covering view.
  242.  
  243. Scrolling dialogs scroll to focused view on mouse button press.
  244.  
  245. TbxMultiBuffScrollBar renamed to TbxMultiScrollBar
  246.  
  247. efXXXX cnstants changed to dfXXXX, there were some efXXXX flags already
  248. defined by TV.
  249.  
  250. Added Date edit lines.
  251.  
  252. Added sliders and spin boxes.
  253.  
  254. Added documentation and pictures for TPxPictureValidators.
  255.  
  256. Added virtual list boxes with unlimited colection size.
  257.  
  258. In TvMenus.pas, changed the names of the constants Marker, MarkerNull, and
  259. MarkerLen to CheckMark, CheckMarkNull, CheckMarkLen.
  260.  
  261. scVScroll and scHScroll in TvScroll.pas changed to ofVScrollBar and
  262. ofHScrollBar for consistency. Old constant names (new values) remain in this
  263. version for compatibility.
  264.  
  265. Changed the name of the type BufData to TBufData.
  266.  
  267. Removed TbxMessageDialog.Process, added an Execute method. Now a message
  268. dialog can be executed like any other dialog by calling ExecuteDialog.
  269.  
  270. ------------------------------------------------------------------------------
  271. KNOWN PROBLEMS (FEATURES!) -
  272.  
  273. Incremental search in the file dialog does not work for drives.
  274.